QuickTime 3 Reference

Previous | Chapter Top | Chapter Contents | Next

Controller Event and Extended Controller Event

The Controller event ( Figure 9 ) changes the value of a controller on a specified part. The Extended Controller event ( Figure 10 ) allows parts and controllers beyond the range of the standard controller event.

Figure 9 Controller event

Table 5Contents of a Controller event

Controller event type

first nibble value = 010X

Part

unique part identifier

Controller

controller to be applied to instrument

Value

8.8 bit fixed point signed controller specific value

For a list of currently supported controller types see "Controller Numbers" .

The part field contains the unique part identifier initially used during the TuneSetHeader call.

The controller bit field is a value that describes the type of controller used by the part.

The value bit field is specific to the selected controller.

Macro call used to stuff the controller event's long word:

qtma_StuffControlEvent(x, instrument, control, value)

Macro calls used to extract fields from the controller event's long word:

qtma_Instrument(x)
qtma_ControlController(x)
qtma_ControlValue(x)

Figure 10 Extended Controller event

Table 6Contents of an Extended Controller event

Extended Controller type

first nibble value = 1010

Part

instrument index for controller

Controller

controller for instrument

Value

signed controller specific value

Event tail

first nibble of last word = 10XX

The part field contains the unique part identifier initially used during the TuneSetHeader call.

The controller bit field contains a value that describes the type of controller to be used by the part.

The value bit field is specific to the selected controller.

Macro call used to stuff the Extended Controller event's long words:

_StuffXControlEvent(w1, w2, instrument, control, value)

Macro calls used to extract fields from the Extended Controller event's long words:

qtma_XInstrument(m, l)
qtma_XControlController(m, l)
qtma_XControlValue(m, l)

© 1997 Apple Computer, Inc.

Previous | Chapter Top | Chapter Contents | Next